home *** CD-ROM | disk | FTP | other *** search
/ .net (French) 1996 November / .net Magazine (FR) - Issue 01 - Nov 1996.iso / mac / Butineur / Netscape Plug-ins / KM's QuickTime plug / Docs 2⁄5⁄95 next >
Text File  |  1996-02-05  |  8KB  |  145 lines

  1. A fat binary multimedia plug-in for Netscape.  Version 0.2.0 (2/5/95)
  2.  
  3.     This is a multimedia Plug-in for Netscape 2.06a.  Web surfers can use this to watch movies and listen to music right from Netscape.  This plug-in offers HTML authors the ability to play background music, stretch movies, present slide shows, and use continuously looping animations.  The plug-in should be placed in Netscape╒s ╥Plug-ins╙ folder.
  4.  
  5. Supported media:
  6. Supported media - MIME - common extension:
  7. QuickTime  -  video/quicktime  -  mov
  8. MPEG  -  video/mpeg  -  mpg   (Requires a special software or hardware MPEG codec.  Not tested.)
  9. Midi  -  audio/x-midi or audio/midi  -  mid   (Requires QuickTime Musical Instruments.)
  10. Windows WAVE  -  audio/x-wave or audio/wave  -  wav
  11. Sun ╡Law  -  audio/basic  -  au
  12. AIFF  -  audio/x-aiff or audio/aiff  -  aif
  13. Mac PICT  -  image/x-pict or image/pict  -  pict
  14.  
  15.  
  16. Improvements since 0.1.0 (1/31/95):
  17. Ñ    Lots of seemingly harmless bugs fixed.
  18. Ñ    Importing of many media types.
  19. Ñ    The default settings will not change the aspect ratio of shrink-to-fit images.
  20. Ñ    Movies will continue where left off when web pages are left and revisited, memory permitting.
  21. Ñ    Printing works.
  22. Ñ    Plain controllers on soundtracks are centered.
  23. Ñ    Zero-area destination boxes are safe.
  24.  
  25. LITTLE BUGS:
  26. Ñ    You may notice window updating bugs that I have not been able to work around.
  27. Ñ    Movies played with a very high frame rate may jump around the window.
  28. Ñ    Printing does not show the controller.
  29.     If you know how to fix these bugs PLEASE E-mail me!!!  The provided source code requires that you have Netscape╒s ╥Mac Plug-in SDK╙ version 2.0 and CodeWarrior.  Don╒t steal my code without giving me credit!!!!
  30.  
  31. Notes:
  32. Ñ    Importing some files can take a long time.  To avoid redundant conversions, this plug-in may set the file type and add a movie resource to any opened files.  Usually this only modifies Netscape╒s cache files but it may also modify files used in disk based viewing.
  33. Ñ    Corrupt movies will generate empty space.
  34. Ñ    This uses QuickTime to convert files.  Make sure you have the latest version of QuickTime, which is currently 2.1, for importing to function.
  35. Ñ    The image of imported PICT files may be lower than the original PICT.  Save the PICT to disk and use a helper application for best image quality.
  36. Ñ    Movies will not play as smoothly from within Netscape as they will if saved and played externally.
  37.  
  38. Troubleshooting:
  39. Ñ    No plug-in response:  The source file may be corrupted or have the wrong file type extension.  I have noticed that some files will not import into QuickTime but may still play fairly well with a sound utility.  Try saving the file and testing it.
  40. Ñ    The file is not delivered to the plug-in:  The web server may not know the MIME type for the file extension used.  You must save the file and convert it manually with a utility or helper application.
  41.  
  42.  
  43. The future:
  44. I may release updates as bugs in my code and Netscape╒s code are fixed.  Removing bug workarounds could improve performance.
  45.  
  46. I am willing to work with other QuickTime plug-in authors to standardize the HTML options format and default settings.  A Netscape document mentioned a palette command but the link to that document is currently invalid.
  47.  
  48. It would be really cool if a Java script could control this.  All I need is Netscape Java support!
  49.  
  50. Someone needs to translate this into Windows code for me.
  51.  
  52. Make this document look cooler.  An HTML version would be nice.
  53.  
  54. How much does it cost:
  55. Nothing, but the source code belongs to me, some interfaces are Netscape╒s, and parts of the binary code may belong to Metrowerks.
  56. My source code may not be used in anything but a freeware product and credit must be given to me (duh).  The program and source code may not be sold for more than the cost of the media it is transferred on.
  57.  
  58. Thanks to Netscape for the Plug-in specifications and demos, Metrowerks for a PPC Pascal compiler, and Apple for the electronic Inside Macintosh series.
  59.  
  60.  
  61.  
  62. For web authors:
  63.  
  64. Use in HTML:
  65.  
  66. <EMBED SRC="Moviename.mov" WIDTH=160 HEIGHT=120> A 160x120 movie
  67.  
  68. <EMBED SRC="Moviename.mov" WIDTH=160 HEIGHT=136> A 160x120 movie with controller
  69.  
  70. <EMBED SRC="Moviename.mov" WIDTH=320 HEIGHT=240> A 160x120 movie at 2x
  71.  
  72. <EMBED SRC="Moviename.mov" WIDTH=320 HEIGHT=256> A 160x120 movie at 2x with controller
  73.  
  74. <EMBED SRC="Moviename.mov" WIDTH=80 HEIGHT=120> A 160x120 movie scaled to 80x60 and a controller
  75.  
  76. <EMBED SRC="Moviename.mov" WIDTH=320 HEIGHT=239> A 160x120 movie with controller and a lot of extra room around it because it wouldn╒t fit as 2x
  77.  
  78. <EMBED SRC="Midiname.mid" WIDTH=160 HEIGHT=20 VOL=600> A 160x20 midi with controller and the volume blasting at 600%
  79.  
  80. <EMBED SRC="Slidename.mov" WIDTH=360 HEIGHT=316 PLACE=F HINTS=SQ PLAY=15 CONTROL=V> A 360x300 slideshow at high quality, playing at 15% of full speed, and with a controller (16 pixels high).
  81.  
  82. Ñ These movies must be flattened, single fork movies.  These can be made using special exporting features of common QuickTime viewers. 
  83.  
  84.  
  85. Special options:
  86. These are the default settings for viewing.
  87. Size:      Exactly 1x, 2x, or smaller than 1x, depending on the destination size.
  88. Placement:  Centered
  89. Controller:  The controller is added if there are at least 16 pixels of height left over after sizing the movie (except for still images).
  90. Volume:  100 (percent)
  91. Dimensionless movies:  These are displayed as a full length controller.
  92. Automatic play:  off.
  93. Hints:  Custom palette off, Slideshow off, Quality is video (except for still images).
  94.  
  95. Currently PICT is the only supported still image.  Other file types will be treated as sound or video.
  96.  
  97.     You can override default display options to allow for hidden sound tracks, special effects, or trade motion quality for image quality.  Note that some options may degrade performance when selected improperly.
  98.  
  99. Setting position of the movie in the boundary.
  100. PLACE=
  101. This command is followed by one or more of these options:
  102. T        Shift to top boundary.
  103. B        Shift to bottom boundary.
  104. L        Shift to left boundary.
  105. R        Shift to right boundary.
  106. F        Force the movie to fit the box, even if it may not play properly.
  107.  
  108.  
  109. Setting the use of the movie controller.
  110. CONTROL=
  111. This command is followed by one of these options:
  112. H        Hidden:  The user can only activate the movie by clicking on it.
  113. V        Visible:  Full user control.  There must be room for the controller.
  114. 0        Zero:   Not visible and no user control of movie.
  115. B        Badge:  The controller is there but not shown until a badge in the video display is clicked.
  116.  
  117.  
  118. Setting movie looping.
  119. LOOP=
  120. This command is followed by one of these options:
  121. L        Linear looping  (start to end, start to end, ╔)
  122. P        Palindrome looping  (start to end, end to start, ╔)  This doesn╒t seem to work with MIDI tracks.
  123.  
  124.  
  125. Starting movie automatically.
  126. PLAY=
  127. This command is followed by an integer percentage to be used as the playback rate.  ╥PLAY=100╙ will start the movie at normal speed.
  128.  
  129.  
  130. Setting the volume.
  131. VOL=
  132. This command is followed by an integer percentage to be used as the volume.  ╥VOL=20╙ will set the volume to 20 percent.
  133.  
  134.  
  135. Special performance hints.
  136. HINTS=
  137. This command is followed by one or more of these options:
  138. S        Slide show:  Do not skip frames and do not play sound.
  139. Q        High Quality:  Use a high quality display rather than a video speed display.  This can be incredibly slow and should include the S option.
  140. P        The movie╒s palette, if there, will be used for the WHOLE Netscape window.  There should only be one of these per page.
  141.  
  142.  
  143. Kevin McMurtrie
  144. mcmurtri@wco.com
  145. 2/5/95